docs: Add annotations for GtkPaned new getters
authorEmmanuele Bassi <ebassi@gnome.org>
Tue, 12 May 2020 17:52:45 +0000 (18:52 +0100)
committerEmmanuele Bassi <ebassi@gnome.org>
Tue, 12 May 2020 17:52:45 +0000 (18:52 +0100)
Which means also adding gtk-doc stanzas.

gtk/gtkpaned.c

index bb3ad6797f2d66d6a95164da08d59b502c893064..b0db80fc5bfe541a63792c5787521faee52812e0 100644 (file)
@@ -1600,6 +1600,16 @@ gtk_paned_set_start_child (GtkPaned *paned,
   g_object_notify (G_OBJECT (paned), "start-child");
 }
 
+/**
+ * gtk_paned_get_start_child:
+ * @paned: a #GtkPaned
+ *
+ * Retrieves the start child of the given #GdkPaned.
+ *
+ * See also: #GtkPaned::start-child
+ *
+ * Returns: (transfer none) (nullable): the start child widget
+ */
 GtkWidget *
 gtk_paned_get_start_child (GtkPaned *paned)
 {
@@ -1662,6 +1672,16 @@ gtk_paned_get_shrink_start_child (GtkPaned *paned)
   return priv->shrink_start_child;
 }
 
+/**
+ * gtk_paned_get_end_child:
+ * @paned: a #GtkPaned
+ *
+ * Retrieves the end child of the given #GdkPaned.
+ *
+ * See also: #GtkPaned::end-child
+ *
+ * Returns: (transfer none) (nullable): the end child widget
+ */
 void
 gtk_paned_set_end_child (GtkPaned *paned,
                          GtkWidget *child)
@@ -1682,6 +1702,7 @@ gtk_paned_set_end_child (GtkPaned *paned,
   g_object_notify (G_OBJECT (paned), "end-child");
 }
 
+
 GtkWidget *
 gtk_paned_get_end_child (GtkPaned *paned)
 {